fix: keep shared HTTP/2 connections pool-owned - #937

After upgrading Hackney from v1 to v4, we immediately started seeing concurrent production requests fail with {error, closed} while another request on the same connection completed successfully.

We traced this to v4 negotiating HTTP/2 by default and the pooled connection remaining owned by the process that created it. When a synchronous requester exits, the shared connection exits with it and interrupts other requests using its streams.

This PR transfers ownership to the pool before publishing a connection for reuse. Registration keeps an existing ready connection, replaces an unusable one, and lets a busy one drain before it stops.

Connection probes, ownership transfers, and candidate shutdowns are bounded. Registration carries a deadline derived from checkout_timeout, falling back to connect_timeout, so expired registrations are rejected even if they reach the pool later. Failed, expired, and duplicate candidates are stopped rather than exposed with uncertain ownership, allowing their per-host slots to be released.

A request waiting for a per-host slot now rechecks whether a busy HTTP/2 connection has become reusable without exceeding the existing checkout timeout. Each HTTP/2 stream also tracks its requester, so an abandoned streaming upload or response in {async, once} mode is cancelled and cannot prevent a replaced connection from retiring.

The first commit adds regression coverage for connection ownership, registration races and cleanup, reuse and retirement of busy HTTP/2 connections, checkout deadlines, and abandoned streams. The second commit contains the implementation.

flowchart TD
    A["Request"] --> B["Look up shared HTTP/2 connection<br/>by host, port and TLS options"]
    B -->|Ready| G
    B -->|Missing or busy| C["Acquire per-host connection slot<br/>While waiting, recheck HTTP/2 reuse"]
    C -->|Existing connection becomes ready| G
    C -->|Slot acquired| D["Check out TCP connection<br/>TLS handshake and ALPN"]
    D -->|HTTP/1.1| H["Exclusive request lifecycle<br/>Return or close after response"]
    D -->|HTTP/2| E["Register synchronously with pool"]
    E -->|Existing connection ready| F["Stop duplicate candidate<br/>Use existing connection"]
    F --> G
    E -->|Accept candidate| I["Transfer ownership to pool<br/>Publish for sharing"]
    I --> G["Send request through hackney_conn<br/>h2_connection owns TLS socket"]
    I -->|Replace busy connection| J["Old connection drains tracked streams<br/>Then stops"]
    G --> K["Track each stream and its consumer"]
    K --> L["Receive response<br/>Complete synchronous call or deliver async data"]
    L --> M["Remove stream when consumed"]
    K -->|Consumer exits| N["Cancel and remove its stream"]
    M --> O["Keep shared connection alive<br/>Stop if retiring and empty"]
    N --> O
    E -->|Failure or expiry| P["Stop candidate"]
    J --> Q["Pool observes termination<br/>Removes connection and releases host slot"]
    P --> Q
    O -->|Connection terminates| Q